package com.spark.swagger3;

import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.Parameters;
import io.swagger.v3.oas.annotations.parameters.RequestBody;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.web.bind.annotation.*;

//这里分组后，下面方法上的分组感觉就没有起作用了，这里是本类全局的分组
//@Tag(name = "分组1")
//具体属性可参考
//https://www.cnblogs.com/ruiyeclub/p/13334826.html
@RestController
@RequestMapping("/index")
public class IndexController {

    //感觉这个分组可以按一个页面来分，这样前端就可以根据哪个页面需要调用什么方法来取接口，
    @Operation(summary = "这是一个hello方法",tags = {"分组2","分组3"})
    @Parameters(value = {
            @Parameter(name = "hello",description = "Hello的实体")
    })
    @GetMapping("/hello")
    public String hello(@RequestBody Hello hello) {
        return hello.toString();
    }

    @Operation(summary = "这是一个word方法",tags = {"分组4","分组1"})
    @PostMapping("/word")
    public @ResponseBody
    Word word() {
        return new Word();
    }
}
